home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / X11 / xbiff.z / xbiff
Text File  |  1998-10-30  |  12KB  |  265 lines

  1.  
  2.  
  3.  
  4.      XXXXBBBBIIIIFFFFFFFF((((1111))))            XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555))))             XXXXBBBBIIIIFFFFFFFF((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           xbiff - mailbox flag for X
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           xxxxbbbbiiiiffffffff [-_t_o_o_l_k_i_t_o_p_t_i_o_n ...] [-option ...]
  13.  
  14.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.           The _x_b_i_f_f program displays a little image of a mailbox.
  16.           When there is no mail, the flag on the mailbox is down.
  17.           When mail arrives, the flag goes up and the mailbox beeps.
  18.           By default, pressing any mouse button in the image forces
  19.           _x_b_i_f_f to remember the current size of the mail file as being
  20.           the ``empty'' size and to lower the flag.
  21.  
  22.           This program is nothing more than a wrapper around the
  23.           Athena _M_a_i_l_b_o_x widget.
  24.  
  25.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  26.           _X_b_i_f_f accepts all of the standard X Toolkit command line
  27.           options along with the additional options listed below:
  28.  
  29.           ----hhhheeeellllpppp   This option indicates that a brief summary of the
  30.                   allowed options should be printed on the standard
  31.                   error.
  32.  
  33.           ----uuuuppppddddaaaatttteeee _s_e_c_o_n_d_s
  34.                   This option specifies the frequency in seconds at
  35.                   which _x_b_i_f_f should update its display.  If the
  36.                   mailbox is obscured and then exposed, it will be
  37.                   updated immediately.  The default is 30 seconds.
  38.  
  39.           ----ffffiiiilllleeee _f_i_l_e_n_a_m_e
  40.                   This option specifies the name of the file which
  41.                   should be monitored.  By default, it watches
  42.                   /usr/spool/mail/_u_s_e_r_n_a_m_e, where _u_s_e_r_n_a_m_e is your
  43.                   login name.
  44.  
  45.           ----vvvvoooolllluuuummmmeeee _p_e_r_c_e_n_t_a_g_e
  46.                   This option specifies how loud the bell should be
  47.                   rung when new mail comes in.
  48.  
  49.           ----sssshhhhaaaappppeeee  This option indicates that the mailbox window should
  50.                   be shaped if masks for the empty or full images are
  51.                   given.
  52.  
  53.           The following standard X Toolkit command line arguments are
  54.           commonly used with _x_b_i_f_f:
  55.  
  56.           ----ddddiiiissssppppllllaaaayyyy _d_i_s_p_l_a_y
  57.                   This option specifies the X server to contact.
  58.  
  59.           ----ggggeeeeoooommmmeeeettttrrrryyyy _g_e_o_m_e_t_r_y
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXBBBBIIIIFFFFFFFF((((1111))))            XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555))))             XXXXBBBBIIIIFFFFFFFF((((1111))))
  71.  
  72.  
  73.  
  74.                   This option specifies the preferred size and
  75.                   position of the mailbox window.  The mailbox is 48
  76.                   pixels wide and 48 pixels high and will be centered
  77.                   in the window.
  78.  
  79.           ----bbbbgggg _c_o_l_o_r
  80.                   This option specifies the color to use for the
  81.                   background of the window.
  82.  
  83.           ----bbbbdddd _c_o_l_o_r
  84.                   This option specifies the color to use for the
  85.                   border of the window.
  86.  
  87.           ----bbbbwwww _n_u_m_b_e_r
  88.                   This option specifies the width in pixels of the
  89.                   border surrounding the window.
  90.  
  91.           ----ffffgggg _c_o_l_o_r
  92.                   This option specifies the color to use for the
  93.                   foreground of the window.
  94.  
  95.           ----rrrrvvvv     This option indicates that reverse video should be
  96.                   simulated by swapping the foreground and background
  97.                   colors.
  98.  
  99.           ----xxxxrrrrmmmm _r_e_s_o_u_r_c_e_s_t_r_i_n_g
  100.                   This option specifies a resource string to be used.
  101.                   This is especially useful for setting resources that
  102.                   do not have separate command line options.
  103.  
  104.      XXXX DDDDEEEEFFFFAAAAUUUULLLLTTTTSSSS
  105.           The application class name is XBiff.  This program uses the
  106.           _M_a_i_l_b_o_x widget in the Athena widget set.  It understands all
  107.           of the core resource names and classes as well as:
  108.  
  109.           cccchhhheeeecccckkkkCCCCoooommmmmmmmaaaannnndddd ((((class CCCChhhheeeecccckkkkCCCCoooommmmmmmmaaaannnndddd))))
  110.                   Specifies a shell command to be executed to check
  111.                   for new mail rather than examining the size of ffffiiiilllleeee.
  112.                   The specified string value is used as the argument
  113.                   to a _s_y_s_t_e_m(3) call and may therefore contain i/o
  114.                   redirection.  An exit status of 0 indicates that new
  115.                   mail is waiting, 1 indicates that there has been no
  116.                   change in size, and 2 indicates that the mail has
  117.                   been cleared.  By default, no shell command is
  118.                   provided.
  119.  
  120.           ffffiiiilllleeee ((((class FFFFiiiilllleeee))))
  121.                   Specifies the name of the file to monitor.  The
  122.                   default is to watch /usr/spool/mail/_u_s_e_r_n_a_m_e, where
  123.                   _u_s_e_r_n_a_m_e is your login name.
  124.  
  125.           oooonnnncccceeeeOOOOnnnnllllyyyy ((((class BBBBoooooooolllleeeeaaaannnn))))
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXBBBBIIIIFFFFFFFF((((1111))))            XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555))))             XXXXBBBBIIIIFFFFFFFF((((1111))))
  137.  
  138.  
  139.  
  140.                   Specifies that the bell is only rung the first time
  141.                   new mail is found and is not rung again until at
  142.                   least one interval has passed with no mail waiting.
  143.                   The window will continue to indicate the presence of
  144.                   new mail until it has been retrieved.  The default
  145.                   is false.
  146.  
  147.           wwwwiiiiddddtttthhhh ((((class WWWWiiiiddddtttthhhh))))
  148.                   Specifies the width of the mailbox.
  149.  
  150.           hhhheeeeiiiigggghhhhtttt ((((class HHHHeeeeiiiigggghhhhtttt))))
  151.                   Specifies the height of the mailbox.
  152.  
  153.           uuuuppppddddaaaatttteeee ((((class IIIInnnntttteeeerrrrvvvvaaaallll))))
  154.                   Specifies the frequency in seconds at which the mail
  155.                   should be checked.  The default is 30.
  156.  
  157.           vvvvoooolllluuuummmmeeee ((((class VVVVoooolllluuuummmmeeee))))
  158.                   Specifies how loud the bell should be rung.  The
  159.                   default is 33 percent.
  160.  
  161.           ffffoooorrrreeeeggggrrrroooouuuunnnndddd ((((class FFFFoooorrrreeeeggggrrrroooouuuunnnndddd))))
  162.                   Specifies the color for the foreground.
  163.  
  164.           rrrreeeevvvveeeerrrrsssseeeeVVVViiiiddddeeeeoooo ((((class RRRReeeevvvveeeerrrrsssseeeeVVVViiiiddddeeeeoooo))))
  165.                   Specifies that the foreground and background should
  166.                   be reversed.
  167.  
  168.           fffflllliiiipppp ((((class FFFFlllliiiipppp))))
  169.                   Specifies whether or not the image that is shown
  170.                   when mail has arrived should be inverted.  The
  171.                   default is ``true.''
  172.  
  173.           ffffuuuullllllllPPPPiiiixxxxmmmmaaaapppp ((((class PPPPiiiixxxxmmmmaaaapppp))))
  174.                   Specifies a bitmap to be shown when new mail has
  175.                   arrived.  The default is flagup.
  176.  
  177.           eeeemmmmppppttttyyyyPPPPiiiixxxxmmmmaaaapppp ((((class PPPPiiiixxxxmmmmaaaapppp))))
  178.                   Specifies a bitmap to be shown when no new mail is
  179.                   present.  The default is flagdown.
  180.  
  181.           sssshhhhaaaappppeeeeWWWWiiiinnnnddddoooowwww ((((class SSSShhhhaaaappppeeeeWWWWiiiinnnnddddoooowwww))))
  182.                   Specifies whether or not the mailbox window should
  183.                   be shaped to the given fullPixmapMask and
  184.                   emptyPixmapMask.  The default is false.
  185.  
  186.           ffffuuuullllllllPPPPiiiixxxxmmmmaaaappppMMMMaaaasssskkkk ((((class PPPPiiiixxxxmmmmaaaappppMMMMaaaasssskkkk))))
  187.                   Specifies a mask for the bitmap to be shown when new
  188.                   mail has arrived.  The default is none.
  189.  
  190.           eeeemmmmppppttttyyyyPPPPiiiixxxxmmmmaaaappppMMMMaaaasssskkkk ((((class PPPPiiiixxxxmmmmaaaappppMMMMaaaasssskkkk))))
  191.                   Specifies a mask for the bitmap to be shown when no
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 4/30/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      XXXXBBBBIIIIFFFFFFFF((((1111))))            XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555))))             XXXXBBBBIIIIFFFFFFFF((((1111))))
  203.  
  204.  
  205.  
  206.                   new mail is present.  The default is none.
  207.  
  208.      AAAACCCCTTTTIIIIOOOONNNNSSSS
  209.           The _M_a_i_l_b_o_x widget provides the following actions for use in
  210.           event translations:
  211.  
  212.           cccchhhheeeecccckkkk(((()))) This action causes the widget to check for new mail
  213.                   and display the flag appropriately.
  214.  
  215.           uuuunnnnsssseeeetttt(((()))) This action causes the widget to lower the flag
  216.                   until new mail comes in.
  217.  
  218.           sssseeeetttt(((())))   This action causes the widget to raise the flag
  219.                   until the user resets it.
  220.  
  221.           The default translation is
  222.  
  223.                   <ButtonPress>:  unset()
  224.  
  225.  
  226.      EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  227.           DDDDIIIISSSSPPPPLLLLAAAAYYYY to get the default host and display number.
  228.  
  229.           XXXXEEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  230.                   to get the name of a resource file that overrides
  231.                   the global resources stored in the RESOURCE_MANAGER
  232.                   property.
  233.  
  234.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  235.           X(1), xrdb(1), stat(2)
  236.  
  237.      BBBBUUUUGGGGSSSS
  238.           The mailbox bitmaps are ugly.
  239.  
  240.      CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT
  241.           Copyright 1988, Massachusetts Institute of Technology.
  242.           See _X(_1) for a full statement of rights and permissions.
  243.  
  244.      AAAAUUUUTTTTHHHHOOOORRRR
  245.           Jim Fulton, MIT X Consortium
  246.           Additional hacks by Ralph Swick, DEC/MIT Project Athena
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 4/30/98)
  262.  
  263.  
  264.  
  265.